home *** CD-ROM | disk | FTP | other *** search
/ Sounds Terrific 2 / Sounds Terrific II (1996)(Weird Science)(Disc 1 of 2)[Amiga-PC].iso / archives / amiga / amichord.lha / AmiChord / chord.man < prev    next >
Text File  |  1993-12-19  |  5KB  |  176 lines
  1.                                     Chord                   27 August 1992
  2.  
  3. NAME
  4.         chord - format lyrics and chord file
  5.  
  6. SYNOPSIS
  7.         chord [-option ...] [ filename... ]
  8.  
  9. DESCRIPTION
  10.  
  11.         chord produces a postscript document from a lyrics file containing 
  12.         chord indications and chorus delimiters. If no filename is supplied,
  13.         chord reads from the standard input. The document produced contains 
  14.         the lyrics of a song, with the guitar chords appearing above the 
  15.         right words. A representation of all chords used in the song is 
  16.         printed at the bottom of the last page.
  17.  
  18. OPTIONS
  19.  
  20. -c chord_font size
  21. Sets the size, in points, of the font used to display chords to the specified
  22. integer value.
  23.  
  24. -C Chord_font
  25. Sets the font used to print chords to the specified name. That name must be
  26. known to your PostScript Interpreter.
  27.  
  28. -d
  29. Dumps the list and description of all internally known chords.
  30.  
  31. -D
  32. Prints debugging information. For programmers only.
  33.  
  34. -g grid_size
  35. Sets the size of the chord grids.
  36.  
  37. -h
  38. Prints a short options summary.
  39.  
  40. -l
  41. Prints only the lyrics of the song.
  42.  
  43. -t text_font size
  44. Sets the size, in points, of the font used to display the lyrics to the
  45. specified integer value. The title line is displayed using that point 
  46. size + 5. The sub-tiltle is displayed using that point size -2.
  47.  
  48. -T Text_font
  49. Sets the font used to print text to the specified name. That name must be
  50. known to your PostScript Interpreter.
  51.  
  52. -V
  53. Prints version and patch level
  54.  
  55. -x half-tones
  56. Sets up transposition to that number of half-tones. Can not be zero. All
  57. chord names must be build in the following way in order to be recognized:
  58.  
  59. {note-name}[#|b][^/]* [ '/' {note-name}[#|b][^/]* ]
  60.  
  61. That is, a valid note name, possibly followed by '#' or 'b', followed by
  62. other modifier ('7', 'm', etc...). Many such construct can make up a chord
  63. name, as long as they are separated by '/'.
  64.  
  65. {note-name} must appear in the list 'A','B','C','D','E','F','G'.
  66.  
  67. -2
  68. Prints two logical pages per physical page.
  69.  
  70. -4
  71. Prints four logical pages per physical page.
  72.  
  73. -i " file"
  74. Generates a table of contents with the song titles and page numbers.  
  75. If file is "-" the table of contents is written to stderr.
  76.  
  77. -a
  78. Automatically single spaces lines that have no chords.
  79.  
  80. -p " first_page"
  81. Numbers the pages consecutively starting with first_page (e.g. 1).
  82. Without this option, each song restarts the page numbering at 1, and page
  83. numbers are only put on subsequent pages of multiple page songs.
  84.  
  85. -R
  86. Places the odd and even page numbers in the lower right and left corners 
  87. respectively (for two-sided output).  The default is all page numbers on 
  88. the right.
  89.  
  90. -L
  91. Places the odd page numbers on the left.
  92.  
  93. KEYWORDS
  94. A line starting with a '#' is interpreted as a comment, and generates no 
  95. output. (although all your comments are automatically mailed to the authors, 
  96. and we read them at parties...)
  97.  
  98. Directives that  appear between french brackets ('{' and '}') have a
  99. special meaning. They must be alone on a line. Blanks before the
  100. opening bracket and after the closing bracket are not significant.
  101.  
  102. Blanks inside a directive are significant.
  103.  
  104. Known directives are:
  105.  
  106. start_of_chorus or soc
  107. which indicates the start of a chorus (yep). The complete chorus will
  108. be highlighted by a change bar, to be easily located by the player.
  109.  
  110. end_of_chorus or eoc
  111. marks the end of the chorus
  112.  
  113. comment: or c:
  114. will call the printing of the rest of the line, highlighted by a grey box
  115. (Useful to call a chorus, for example)
  116.  
  117. new_song or ns
  118. marks the beginning of a new song. It enables you to put multiple songs
  119. in one file. It is not required at the beginning of the file.
  120.  
  121. title: ort:
  122. specifies the title of the song. It will appear centered at the top of the first
  123. page, and at the bottom of every other page, accompanied there by the
  124. page number, within the current song.
  125.  
  126. subtitle: or st:
  127. specifies a string to be printed right below the title. Many subtitles can be
  128. specified
  129.  
  130. define: name offset str1 ... str6
  131. defines a new chord called "name", starting at fret "offset".
  132. The following numbers
  133. are the fret number [ 1 to n ] for each string [str1 to str6]
  134. and are RELATIVE to the offset.  A value of "-" as 
  135. the fret number on a string means that string is not played.
  136. Open strings indicated with a fret value of 0 are represented by a small 
  137. open circle above the string. A value of "x" or "X" as the fret number means 
  138. that string is to be buffed, or silenced. This will be represented by an "x" 
  139. appearing above the string. The strings are numbered in descending order of 
  140. tonality, starting on the high E (the bottom string).
  141.  
  142. At the beginning of every song, the default chords are loaded and the 
  143. ~/.chordrc file is re-read. Definition of new chords are preserved for the 
  144. remainder of the execution, or until redefined by the user.
  145.  
  146. textfont: postscript_font
  147. same as -T command option
  148.  
  149. textsize: n
  150. same as -t command option
  151.  
  152. chordfont: postscript_font
  153. same as -C command option
  154.  
  155. chordsize: n
  156. same as -c command option
  157.  
  158. FILES
  159.  
  160. $HOME/.chordrc
  161. Initial directives re-read after each song.
  162.  
  163. COPYRIGHT
  164. Copyright 1992 by Martin Leclerc and Mario Dorion
  165.  
  166. AUTHORS
  167. Martin Leclerc
  168. (martin.leclerc@canada.sun.com)
  169.  
  170. Mario Dorion
  171. (mario.dorion@canada.sun.com)
  172.  
  173. CONTRIBUTORS
  174. Steve Putz (putz@parc.xerox.com)
  175. Jim Gerland (GERLAND@ubvms.cc.buffalo.edu)
  176.